本篇介紹 ES2020 (ES11) 提供的 Promise.allSettled()。

前言

在開始介紹 Promise.allSettled() 之前，先對說明一些專有名詞。

Promise 有三種狀態：

• pending：Promise 還未 fulfilled，也未 rejected 的狀態
• fulfilled：Promise 已經 fulfilled
• rejected：Promise 已經 rejected

spec 定義如下：

• promise 已經 settled 代表 promise 不是 pending，即代表已經 fulfilled 或 rejected
• 若 promise 已經 settled 或已變成另一個狀態時，代表 promise 已經 resolved
• 嘗試 resolve 或 reject 某個 resolved promise 不會有任何效果
• unresolved 的 promise 會一直處於 pending 狀態
• resolved 的 promise 可能是 pending、fulfilled 或 rejected

各種 Promise method

在提案中有提到幾個 Promise method，包含過去的 Promise.all()、Promise.race()、本篇要介紹的 Promise.allSettled()，以及之後會介紹的 Promise.any()：

資料來源

• tc39/proposal-promise-allSettled
• JavaScript Promise combinators: .all(), .race(), .allSettled() | 2ality